home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / sound / players / jukebx~1.zoo / jukebx14 / doc / jukebox.txt < prev    next >
Text File  |  1992-05-14  |  7KB  |  173 lines
  1. Program and this text is Copyright (C) 1991 by Klaus Pedersen.
  2.  
  3. JUKEBOX is a Public Domain program by
  4.  
  5.       Klaus Pedersen
  6.       Nyborgvej 217 4. TH
  7.       DK-5220 Odense SØ
  8.       Denmark
  9.  
  10.  
  11.       EMAIL : micro@imada.ou.dk
  12.  
  13. You should check that you have the following files in the JUKEBOX
  14. directory:
  15.    JUKEBOX\
  16.       \TOOL.SRC            ; source to IRQTIMER, MOD_PEEK and LIST_MOD
  17.       \DOC\
  18.          JUKEBOX.TXT       ; This file.
  19.          RAVINGS.TXT       ; About the other players.
  20.          CHANGES.TXT       ; Quick index to changes.
  21.          OK_MODS.TXT       ; List of Modules that I have checked.
  22.       JUKEBOX.ACC          ; THE Program & Resources
  23.       JUKEBOX.PRG          ; JUKEBOX.ACC with a .PRG extension
  24.       MOD_PEEK.TTP         ; Program to check and disassemble a module.
  25.       LIST_MOD.TTP         ; Program that list all MODs in a directory
  26.       IRQTIMER.PRG         ; Program to messure time used by IRQ
  27.       NT_COMP.PRG          ; Compiler for Modules
  28.       IRQTIMER.RSC         ; RSC file for messure program.
  29.       NT_COMP.RSC          ; RSC file for NT_COMP.
  30.       
  31.  
  32. ---------------------------------------------------------------------
  33. / / / / / / / / INTRODUCTION  / / / / / / / / / / / / / / / / / / / /
  34. ---------------------------------------------------------------------
  35. Jukebox is a program to play Noisetracker modules (MOD's) and SEGM
  36. files in the background. Tracker MOD's is a popular music format on
  37. the amiga. This program emulates the amiga hardware.
  38.  
  39. The 'Noisetracker' player build into Jukebox is fully compatible with
  40. NoiseTracker v2.0 on the amiga (except that you can't flip the
  41. power-on LED ;-) ).
  42.  
  43. SEGM files was first used in the PD program NT_COMP. NT_COMP can be
  44. used to convert 'MOD' files into SEGM format. SEGM files don't use
  45. the processor (much) when playing, that can NOT be said about a 'MOD'
  46. player...
  47.  
  48. Jukebox should run on all Atari computers with DMA sound - read
  49. [MEGA] STe and TT computers, but not old ST's, BOOK and PAD. 
  50.  
  51.  
  52. ---------------------------------------------------------------------
  53. / / / / / / / / INSTALATION / / / / / / / / / / / / / / / / / / / / /
  54. ---------------------------------------------------------------------
  55. The program can be used in 3 ways:
  56.     - as an accessory
  57.     - installed to take *.MOD, *.SEG or as a GTP program (TOS ≥ 2.0)
  58.     - started as a normal program.
  59.  
  60. The program can only play in the background when the program is
  61. installed as an accessory.
  62.  
  63.  
  64. MEMORY
  65.  
  66. When the program is used as a accesory it let you allocate memory for
  67. the music files while you are on the Desktop. When you load a file
  68. from the desktop, you automaticly allocate resident memory for it. If
  69. you load a file while an other program is running (not the Desktop),
  70. then it will be put into resident memory if it fits there, otherwise
  71. it won't be loaded!
  72.  
  73. Under the menu 'Options/Keep' can you see how much memory you have
  74. resident. It is also possible to change the amount of memory to
  75. 'Keep' by hand, simply by using the up and down arrows. Notice that
  76. the memory isn't allocated before you click on the number! Next to
  77. the up and down arrows are an close-icon, click on this to release
  78. all resident memory.
  79.  
  80. If you choose the menu 'File/Free & Lock!' then ALL memory that the
  81. Jukebox is using will be released. (except the program itself)
  82. If you try to open the Jukebox again you will get a dialogbox that 
  83. says something like :
  84.  
  85.             !!!  The Jukebox is LOCKED! You
  86.             !!!  can only reopen it on the
  87.              !   Desktop. Press 'Unlock' to
  88.              O   override the protection.
  89.                    [  OK  ] [ Unlock ]
  90.  
  91. If you choose 'Unlock' then the Jukebox will allocate memory and make
  92. the program you run the new 'desktop' - the place where it will let
  93. you allocate resident memory. Use this with care, because if you
  94. terminate that program while the music is playing you have serious
  95. problems (well, bombs).
  96.  
  97. Hint: This can be used together with gemini and neodesk:
  98.       Boot, 'Free & Lock' the Jukebox, start Gem Shell, open
  99.       the Jukebox and 'Unlock'.
  100.  
  101.  
  102. SAVE SETUP
  103.  
  104. When you boot the system then the Jukebox will search for a file
  105. called 'JUKEBOX.CFG', if it finds the file it will remember where it
  106. was and read the setup. In the config file there is the path to your
  107. modules and prefered playback frequency, amount of resident memory,
  108. player and such. If you choose the menu 'Save Setup', then the
  109. Jukebox will save the config file at the place it was found at boot
  110. time.
  111.  
  112.  
  113. PLAYERS
  114.  
  115. I have build 6 players into the Jukebox, these have differend strong
  116. points. Interpolation gives the best sound, but it is only sane on an
  117. TT. The TT can play interpolation at 50KHz. The STe can play at
  118. 6.25KHz (until you vriggle the mouse). The other players plays well
  119. on a STe (at 12.5KHz) and the 'Fastest' can play at 25KHz.
  120.  
  121.                      Speed   Quality
  122. Mono, Good S/N       : 1,      good sound.
  123. Interpolation Mono   : 0,      very good sound.
  124. Fastest Mono         : 3,      crappy sound.
  125.  
  126. Stereo, Good S/N     : 1,      good sound.
  127. Stereo, No Clipping  : 2,      good sound, a bit lower volume (6dB).
  128. Stereo, Interpolation: 0,      very good sound.
  129.  
  130. Speed = 0..3 where 0 is slow and 3 is fast.
  131. All players use full volume and frequency on all voices (even the
  132. fast one).
  133.  
  134.  
  135. NOTE, IMPORTANT
  136.  
  137. And just one other thing, don't change rez with the music playing.
  138. (Please...).
  139.  
  140.  
  141.  
  142. WHAT DO *I* DO?
  143. ---------------
  144. I would like you to contribute with : Ideas (for further developments)
  145. and code that you think needs to be included (I need compression code,
  146. filters and such). If this program shall improve and grow, then I need
  147. your help! Send in BUG-reports (I can't test the program on your
  148. computer - I need your help to do that!). If there is a thing you
  149. think is ackward or silly let me know, _DO_NOT_ say "this is obvious,
  150. someone else have told him", tell me yourself!
  151.  
  152. If you find BUGs then _please_ send them to me with the following
  153. information:
  154.   o  Computer (STe, TT, MEGA STe, SST)
  155.   o  Memory.
  156.   o  Extra Hardware (PC emulator, Speed up card).
  157.   o  TOS version.
  158.   o  Programs in the Auto folder
  159.   o  Accesorys.
  160.  
  161. There are 3 ways to contact me :
  162.  
  163. SNAIL MAIL                  EMAIL                VOICE PHONE
  164. Klaus Pedersen              micro@imada.ou.dk    66 15 58 79
  165. Nyborgvej 217 4.TH.                              (from Denmark)
  166. DK-5220 Odense SØ
  167. Denmark.
  168.  
  169. What language should you write to me in? I prefer C and Assembler,
  170. and I don't understand a word Basic. You can fill in with
  171. Scandinavian, English and Modern (Computer) German...
  172.  
  173.